home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / pntsmooth.z / pntsmooth
Encoding:
Text File  |  1998-10-20  |  6.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ppppnnnnttttssssmmmmooooooootttthhhh((((3333GGGG))))                                                    ppppnnnnttttssssmmmmooooooootttthhhh((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ppppnnnnttttssssmmmmooooooootttthhhh - specify antialiasing of points
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd ppppnnnnttttssssmmmmooooooootttthhhh((((mmmmooooddddeeee))))
  13.      uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg mmmmooooddddeeee;;;;
  14.  
  15. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  16.      _m_o_d_e   expects one of two values:
  17.  
  18.             SSSSMMMMPPPP____OOOOFFFFFFFF defeats antialiasing of points (default).
  19.  
  20.             SSSSMMMMPPPP____OOOONNNN enables antialiasing of points.  It can be modified by an
  21.             optional symbolic constant:
  22.  
  23.             SSSSMMMMPPPP____SSSSMMMMOOOOOOOOTTTTHHHHEEEERRRR indicates that a higher quality filter should be used
  24.             during point drawing.  This filter typically requires that more
  25.             pixels be modified, and therefore potentially reduces the rate at
  26.             which antialiased points are rendered.
  27.  
  28.      The constant SMP_SMOOTHER is specified by bitwise ORing it, or by adding
  29.      it, to SMP_ON.  For example:
  30.  
  31.           pntsmooth(SMP_ON + SMP_SMOOTHER);
  32.  
  33.  
  34.      enables antialiased point drawing with the highest quality, and
  35.      potentially lowest performance, algorithm.  The modifier is a hint, not a
  36.      directive, and is therefore ignored by systems that do not support the
  37.      requested feature.
  38.  
  39. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  40.      ppppnnnnttttssssmmmmooooooootttthhhh controls the capability to draw antialiased points.  You can
  41.      draw antialiased points in either color map mode or RGB mode.
  42.  
  43.      For color map antialiased points to draw correctly, you must initialize a
  44.      16-entry colormap block (whose lowest entry location is a multiple of 16)
  45.      to a ramp between the background color (lowest index) and the point color
  46.      (highest index).  Before drawing points, clear the area to the background
  47.      color.
  48.  
  49.      The pntsmooth hardware replaces the least significant 4 bits of the
  50.      current color index with bits that represent pixel coverage.  Therefore,
  51.      by changing the current color index (only the upper 8 bits are
  52.      significant) you can select among many 16-entry color ramps, representing
  53.      different colors and intensities.  You can draw depthcued antialiased
  54.      points in this manner.
  55.  
  56.      The z-buffer hardware can be used to improve the quality of color map
  57.      antialiased point images.  Enabled in the standard depth-comparison mode,
  58.      it ensures that points nearer the viewer obscure more distant points.
  59.      Alternately, the z-buffer hardware can be used to compare color values by
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ppppnnnnttttssssmmmmooooooootttthhhh((((3333GGGG))))                                                    ppppnnnnttttssssmmmmooooooootttthhhh((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      issuing:
  75.  
  76.           zbuffer(TRUE);
  77.           zsource(ZSRC_COLOR);
  78.           zfunction(ZF_GREATER);
  79.  
  80.  
  81.      Pixels are then replaced only by 'brighter' values, resulting in better
  82.      intersections between points drawn using the same ramp.
  83.  
  84.      RGB antialiased points can be drawn only on machines that support
  85.      blending.  For these points to draw correctly, the blendfunction must be
  86.      set to merge new pixel color components into the framebuffer using the
  87.      incoming (source) alpha values.  Incoming color components should always
  88.      be multiplied by the source alpha (BF_SA).  Current (destination) color
  89.      components can be multiplied either by one minus the source alpha
  90.      (BF_MSA), resulting in a weighted average blend, or by one (BF_ONE),
  91.      resulting in color accumulation to saturation; issue:
  92.  
  93.           blendfunction(BF_SA, BF_MSA); /* weighted average */
  94.  
  95.  
  96.      or
  97.  
  98.           blendfunction(BF_SA, BF_ONE); /* saturation */
  99.  
  100.  
  101.      The pntsmooth hardware scales incoming alpha components by an 8-bit
  102.      computed coverage value.  Therefore reducing the incoming source alpha
  103.      results in transparent, antialiased points.
  104.  
  105.      RGB antialiased points draw correctly over any background image.  It is
  106.      not necessary to clear the area in which they are to be drawn.
  107.  
  108.      Both color map and RGB mode points are antialiased effectively only when
  109.      subpixel mode is enabled; issue:
  110.  
  111.           subpixel(TRUE);
  112.  
  113.  
  114.      The size of antialiased points is controlled by ppppnnnnttttssssiiiizzzzeeee and ppppnnnnttttssssiiiizzzzeeeeffff....
  115.      Although point size can be arbitrarily specified, only a small, hardware
  116.      specific number of point sizes is actually supported.  (Refer to the
  117.      ppppnnnnttttssssiiiizzzzeeee manpage.)
  118.  
  119.      The modifier SMP_SMOOTHER can be ORed or ADDed to the symbolic constant
  120.      SMP_ON when antialiased points are enabled.  When this is done, a higher
  121.      quality and potentially lower performance filter is used to scan convert
  122.      antialiased points.  SMP_SMOOTHER is a hint, not a directive.  Thus a
  123.      higher quality filter is used only if it is available.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ppppnnnnttttssssmmmmooooooootttthhhh((((3333GGGG))))                                                    ppppnnnnttttssssmmmmooooooootttthhhh((((3333GGGG))))
  137.  
  138.  
  139.  
  140. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  141.      bgnpoint, blendfunction, endpoint, gversion, pntsize, linesmooth,
  142.      subpixel, v, zbuffer, zfunction, zsource
  143.  
  144. NNNNOOOOTTTTEEEESSSS
  145.      This routine does not function on IRIS-4D B or G models, or on the
  146.      Personal Iris.  Use ggggvvvveeeerrrrssssiiiioooonnnn to determine which type you have.
  147.  
  148.      IRIS-4D GT and GTX models, as well as the Personal Iris, Iris Entry,
  149.      Indy, XL, XS, XS24, XZ, Elan and Extreme systems do not support
  150.      SMP_SMOOTHER.  These systems ignore this hint.
  151.  
  152.      Iris Entry ppppnnnnttttssssmmmmooooooootttthhhh support is only valid for color index mode.
  153.  
  154. BBBBUUUUGGGGSSSS
  155.      Color-comparison z-buffering is not supported on the IRIS-4D GT or GTX
  156.      models.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.